home *** CD-ROM | disk | FTP | other *** search
/ The Very Best of Atari Inside / The Very Best of Atari Inside 1.iso / sharew / musik / diti_tra.ck / dt_modul.eng / modulkit.doc < prev    next >
Encoding:
Text File  |  1994-10-20  |  7.8 KB  |  171 lines
  1. 06601030305800
  2. F0110030
  3. 9[...................................................]001
  4. Ç************************************************************************
  5. *                                                                      *
  6. *         DigiTape Effect Module Construction Kit                      *
  7. *         ---------------------------------------                      *
  8. *                                                                      *
  9. *           How to build loadable Modules for                          *
  10. *                 DigiTape Release 2.0                                 *
  11. *                   7. Juli 1993                                       *
  12. *                                                                      *
  13. ************************************************************************
  14.  
  15. DigiTape unterstützt ab der Version 1.03  freie Effektmodule.
  16.  
  17. Das heißt, daß jeder, der sich zu einem bißchen C- und 
  18. etwas mehr DSP-Assembler-Programmierung in der Lage sieht, 
  19. nachladbare Module mit Klageffekten erstellen kann, die in 
  20. DigiTape eingebunden werden.
  21.  
  22. Wir stellen anbeiEntwicklerinformationen über das Softwareinterface
  23. und die Verbindung zu DigiTape zur Verfügung.
  24.  
  25. Weitere Informationen, die benötigt werden, finden sich im 
  26. Motorola Entwicklerhandbuch zum DSP 56k sowie im Falcon 
  27. Entwicklerkit von Atari, das Sie bei Atari Computer GmbH in
  28. Schwalbach bestellen können.
  29.  
  30. Beachten Sie bitte die Artikelserie "DSP-Programierung" in der
  31. ST Comuter, Heim Verlag.
  32.  
  33. Weiterhin möchten wir auf eine Artikelserie mit dem Titel
  34. "Klangwunder" in der Zeitschrift c't verweisen, die auf 
  35. Soundprogrammierung für den DSP 56k / Falcon 030 
  36. gezielt eingeht:
  37.  
  38. "Klangwunder" in c't Heise Verlag, Heft  9/93 S. 226ff
  39.                                    Heft 10/93 S. 212ff
  40.                                    Heft 11/93 S. 260ff
  41.  
  42.  
  43. External Digitape modules contain DSP56000 code, GEM Recources and the
  44. user-interface code in one file. The modules are loadable from within the
  45. Digitape desktop and can be handled like interanal ones. If an external
  46. module is used together with a recording, it is automatically loaded
  47. next time the recording tape is opened.
  48.  
  49. As an Example we supply a complete module wich implements a reverb effect:
  50.  
  51. Sourcefiles:
  52. -------------
  53. resource:      HALL.RSC
  54.                HALL.H
  55.                HALL.DFN
  56.  
  57. DSP assembler: HALL.ASM
  58. Ç
  59. User interface:HALL.C
  60.                DT_DEFIN.H
  61.                DT_LOCAL.H
  62.  
  63. projectfiles:  HALL.PRJ
  64.                MAKEFILE
  65.  
  66. Tools:
  67. ------
  68. You need:      C Programming Environment
  69.                Resource Construction Set
  70.                DSP56000 Assembler
  71.                (a Make Programm, not nessesary but simplifies the calls
  72.                the other tools)
  73.  
  74. We supply:     CLN_TO_D.TTP   builds a C source file out of a DSP
  75.                               assembler object file.
  76.                               HALL.CLN becomes HALL.D and HALL.DH.
  77.  
  78.                RSC_TO_C.TTP   GEM resource to C converter.
  79.                               HALL.RSC becomes HALL.R
  80.  
  81. Building procedure:
  82. -------
  83.  
  84.       *---------------*       *----------*  *----------*  *-----------*
  85.       |   HALL.ASM    |       | HALL.RSC |  |  HALL.H  |  | HALL.C    |
  86.       |               |       |          |  |          |  |           |
  87.       | DSP assembler |       |   GEM    |  | resource |  |  C file   |
  88.       |   source      |       | resource |  |  defines |  | interface |
  89.       *---------------*       *----------*  *----------*  *-----------*
  90.               |                     |             |             |
  91.               V                     V             |             |
  92.       =================    ==================     |             |
  93.       = ASM56000.TTP  =    = RSC_TO_C.TTP   =     |             |
  94.       = DSP assembler =    =   resource     =     --------> #include
  95.       =               =    =   converter    =                   |
  96.       =================    ==================                   |
  97.               |                     |                           |
  98.               V                     V                           |
  99.       *---------------*      *-------------*                    |
  100.       |   HALL.CLN    |      |   HALL.R    |                    |
  101.       |               |      |             |                    |
  102.       |  DSP object   |      |  resource   |                    |
  103.       |               |      | as C source |                    |
  104.       *---------------*      *-------------*                    |
  105.               |                     |                           |
  106.               V                     |                           |
  107.      ===================            |                           |
  108.      =  CLN_TO_D.TTP   =            |                           |
  109.      =  convert tool   =            ----------------------> #include
  110.      =                 =                                        |
  111.      ===================                                        |
  112. Ç         |          |                                           |
  113.          V          V                                           |
  114. *-------------*  *-------------*                                |
  115. |   HALL.D    |  |   HALL.DH   |                                |
  116. |             |  |             |                                |
  117. | DSP object  |  | DSP defines |                                |
  118. | as C source |  | as C source |                                |
  119. *-------------*  *-------------*                                |
  120.        |                |                                       |
  121.        |                ----------------------------------> #include
  122.        |                                                        |
  123.        ---------------------------------------------------> #include
  124.                                                                 |
  125.                            DT_DEFIN.H --------------------> #include
  126.                                                                 |
  127.                            DT_LOCAL.H --------------------> #include
  128.                                                                 |
  129.                                                                 V
  130.                                              =========================
  131.                                              =  C-Compiler & Linker  =
  132.                                              =     Make HALL.PRJ     =
  133.                                              =                       =
  134.                                              =========================
  135.                                                          |
  136.                                                          V
  137.                                                *------------------*
  138.                                                |*----------------*|
  139.                                                ||   HALL.DTM     ||
  140.                                                ||                ||
  141.                                                || DigiTape-Module||
  142.                                                |*----------------*|
  143.                                                *------------------*
  144.  
  145.  
  146.  
  147. A few restrictions to your DSP code:
  148. ------------------------------------
  149.  
  150. Identifiers have to be at most 7 characters long.
  151.  
  152. ORG-Directives are not permitted.
  153.  
  154. Calculations in Directtives are not permitted.
  155. Example:  move  X1,X:DATUM   ; OK
  156.           move  X1,X:DATUM+1 ; not OK
  157.  
  158. Modules should return with RTS.
  159.  
  160. Access to L-Memory (X- and Y-Memory together) is not permitted.
  161.  
  162. Following registers are used internally and you should absolutely
  163. NOT use them within your code: R3,M3,N3
  164.  
  165. Registers M0-M2 and M4-M7 have to contain 0xFFFF after each module call,
  166. Çthat means, if you change them, set them back to $FFFF
  167.  
  168. All other registers are at your disposal.
  169.  
  170.  
  171.